************
INTRODUCTION
************

This file describes how to set up and use the Perl wrapper code with Melissa DATA's Name Object.


*************
PREREQUISITES
*************

To make use of the Name Object Perl wrapper you will need:

* An installation of a Perl. Wrapper tested with Perl 5.10. 

* The Melissa DATA Name Object library and data files installed.
  These files are installed automatically if you run setup.exe. By default, the Name Object 
  Library (mdName.dll) is installed in:
	C:\Program Files\Melissa DATA\DQT\NameObj\dll_32bit
* 64bit version available in C:\Program Files\Melissa DATA\DQT\NameObj\dll_64bit

  and the Name Object data files in:
	C:\Program Files\Melissa DATA\DQT\Data

You will need to know the location of these items in order to install and run the Perl wrapper.

**********************
Wrapper compatibility
**********************

If the provided pre-compiled wrappers are not compatible with your environment, the necessary files for compilation can be found in the 'interfaces' folder of the object's main directory.



***********
Demo Mode
***********

Please contact your sales representative to unlock of Name Object free for 30 days.  Name Object
will not function without a valid license string. Please call 1-800-MELISSA ext. 3 for
more information.


*************
Installation
*************

Copy the entire folder that contains this readme.txt into a local directory on your computer.


*****
Setup
*****

You will need to allow mdNamePerlWrapper.dll to find mdName.dll. You can do this by:

	1. Adding the directory containing mdName to your PATH environment variable. 
	   ex: set PATH=%PATH%;C:\Program Files\Melissa DATA\COM Objects\NameObj\dll_32bit

* 64bit version available in C:\Program Files\Melissa DATA\DQT\NameObj\dll_64bit

	or

	2. Copy mdName.dll into the directory with mdNamePerlWrapper.dll.



**************************
Setting up the Sample Code
**************************

Open NameSample.pl for editing. You must set the a license string that you receive from your Melissa Data
sales representative:

	my $LICENSE = "license here";

and also the path to the Name Object Data Files:

	my $FILELOC = "C:\\Program Files\\Melissa DATA\\DQT\\Data;


***********************
Running the Sample Code
***********************

Navigate to the directory containing the Perl wrapper using command line and type:
	'perl NameSample.pl'

*******
Updates
*******

The files generated/included in this wrapper do not need to be changed for DQ Suite updates unless there is a method signature change in the object. If a new method is added, you will need to rebuild the wrapper to use 
the new method. 



****
Note
****

Here are some general solutions if you run into problems:

Q. I get an error saying "can't find mdName.dll."
A. This means that mdNamePerlWrapper.dll cannot link to mdName.dll. Please follow the steps in
the Setup section above.

Q. I get an error saying "can't find perl510.dll."
A. The current mdNamePerlWrapper.dll was compiled using Perl 5.10. You are probably using another version of
perl. You will need another version of mdNamePerlWrapper.dll that uses the version of perl on your system. 
Please look in the "Source" folder and read the readme for instructions. 


COPYRIGHT NOTICE

(C) 2014 Melissa Data Corporation. All rights reserved.
